What’s New in MariaDB Connector/C 3.0

We are pleased to announce the general availability (GA) of MariaDB Connector/C 3.0. MariaDB Connector/C 3.0.2 is the newest version of MariaDB Connector/C. This release is compatible with MariaDB Connector/C 2.3 – no code changes necessary to upgrade.

MariaDB Connector/C 3.0 includes new security enhancements, plugins and API functions.


In addition to OpenSSL, MariaDB Connector/C 3.0 now supports:

  • GnuTLS
  • Windows SChannel: removes dependencies on external libraries
  • Windows SChannel: becomes the default for SSL on Windows
  • TLSv1.1 and TLSv1.2 support
  • Passphrase protected private keys


  • All plugins can either be linked statically or built as shared objects (or dynamic link libraries on Windows)
  • Pluggable Virtual IO (PVIO) for communication via socket, named pipe and shared memory
  • Connection plugins, e.g for Aurora failover or replication (master write, slave read)
  • Remote IO plugin, which allows to access remote files (via http, https, ftp, ldap, …)
  • Trace plugin (for analyzing and dumping network traffic)
  • New GSSAPI authentication plugin

New API Functions

MariaDB Connector/C 3.0 is introducing the following new API functions:

  • Bulk operations (array binding) for prepared statements (insert, update, delete).
  • support for extended client/server capabilities (requires MariaDB 10.2 or newer)
  • mariadb_get_charset_by_name and mariadb_get_charset_by_nr, which return charset information for a given internal number or name of character set. These functions have been previously used internally by MariaDB Connector/ODBC and are now exported, so they can be used also within plugins.
  • mariadb_stmt_execute_direct prepares and executes in one step (mainly used by MariaDB ODBC driver)
  • mariadb_cancel aborts a connection immediately by making all subsequent read/write operations fail
  • mysql_get_option and mysql_get_optionv (variable argument list) for obtaining option values for a given connection.
  • mysql_reconnect which was used internally before (if the option MYSQL_OPT_RECONNECT was set) is now part of the API and can be used by applications and plugins to re-establish a failing connection
  • mysql_reset_connection resets the current connection and clears session state
  • mysql_stmt_warning_count returns warnings per statement
  • Functions for obtaining session state changes:
    • mysql_session_track_get_first
    • mysql_session_track_get_next
  • Added tls_version support for SChannel. tls_version has to be specified via mysql_options(mysql, MARIADB_OPT_TLS_VERSION, …)

Download the MariaDB Connector now and learn about the newest evolution of MariaDB Connector/C 3.0.

Download Knowledge Base