Windows

• Visual Studio 2013 or newer (older versions of Visual Studio may also work but have not been tested).

• cmake 2.8.12 or newer, available from the CMake website.

• for Connector/C 2.x: OpenSSL libraries and include files.

• for Connector/C 3.0 remote-io plugin: libraries and include files

Linux / Mac OS X

The following is a list of tools that are required for building MariaDB Connector/C on Linux and Mac OS X. Most, if not all, of these will exist as packages in your distribution's package repositories, so check there first.

• gcc 3.4.6 or newer C compiler

• TLS/SSL libraries and include files

  • OpenSSL 1.0.1 or newer or

  • GnuTLS 3.4 or newer

On Linux you can get those programs with your package manager. On Mac OS X you will need Xcode and to install the remaining programs with or .

After successful configuration, Connector/C can now be compiled.

Compiling on Windows

If no CMake generator was specified, CMake creates by default build files for Visual Studio. You can now either build Connector/C inside Visual Studio

devenv mariadb_connector_c.sln

or via command line

cmake --build . --config RelWithDebInfo

Compiling on Unix

By default CMake creates build files for GNU make. On some system GNU make is renamed to gmake. You can now build Connector/C with

or

Configuration settings

Connector/C specifies its build process with platform-independent CMake listfiles included in each directory of a source tree with the name CMakeLists.txt. Configuration settings may be specified by passing the -D option to CMake command line interpreter.

Do not build Connector/C from the root of the source tree: Either create a subdirectory "build" inside the source tree or create a subdirectory outside of the source tree.

Example:

Reconfiguration

In case Connector/C was already configured, the CMakeCache.txt file needs to be removed first. In several cases, e.g. when cross compiling CMakeFiles subfolders need to be removed too.

Generator options

If you want to use a different generator, e.g. for nmake on Windows, you need to specify the generator with the -G option. cmake --help lists the available generators for the used platform.

CMake-related configuration settings

TLS/SSL options

Client plugins

Client plugins can be configured as dynamic plugins (DYNAMIC) or built-in plugins (STATIC) by specifying the plugin name followed by suffix _PLUGIN_TYPE as key, and "DYNAMIC" or "STATIC" as value.

E.g. for building dialog plugin as a built-in plugin, for versions < Connector/C 3.0.4

Beginning with C/C 3.0.4

Connector/C 3.0 supports the following plugins: