Configuration settings
Configuration settings
Connector/C specifies his build process with platform-independent CMake listfiles included in each directory of a source tree with the name CMakeLists.txt. Configuration options may be specified by passing the -D option to CMake command line interpreter.
Example:
cmake ../connector_c -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local
Generator options
If you want to use a different generator, e.g. for nmake on Windows you need to specify the generator with option -G
. cmake --help
lists the available generators for used platform.
CMake related configuration settings
CMAKE_BUILD_TYPE | Build type: Release, RelWithDebInfo or Debug |
CMAKE_INSTALL_PREFIX | Installation base directory |
CMAKE_C_FLAGS | Flags for C-Compiler |
TLS/SSL options
Option | Default | Description |
WITH_OPENSSL | ON | Possible values are ON or OFF. Not supported anymore since Connector/C 3.0 |
WITH_SSL | SCHANNEL (windows), otherwise OPENSSL | Specifies type of TLS/SSL library. E.g. GNUTLS, OPENSSL or SCHANNEL (Windows only). OFF disables TLS/SSL functionality |
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
cmake .. -DAUTH_DIALOG_PLUGIN_TYPE=STATIC
Connector/C 3.0 supports the following plugins:
Plugin | Type | Default | Description |
SOCKET | IO | static | plugin for client server communication via socket |
SHMEM | IO | static | plugin for client server communication via shared memory |
NPIPE | IO | static | plugin for client server communication via named pipe |
AUTH_DIALOG | Authentication | dynamic | Authentication for user input, e.g. for PAM authentication |
AUTH_OLDPASSWORD | Authentication | static | Pre. 4.1 authentication (deprecated) |
AUTH_NATIVE | Authentication | static | Default authentication |
AUTH_CLEARTEXT | Authentication | dynamic | Sends password without hashing or encryption |
AUTH_GSSAPI | Authentication | dynamic | Kerberos/GSSAPI authentication plugin |
AURORA | Connection | Dynamic | Fail over plugin for Aurora (experimental) |
REPLICATION | Connection | dynamic | Replication/fail over plugin (experimental) |
TRACE_EXAMPLE | Connection | dynamic | Trace plugin for client/serve protocol (experimental) |