> For the complete documentation index, see [llms.txt](https://mariadb.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://mariadb.com/docs/connectors/mariadb-connector-c/building-connectorc-from-source/configuration-settings-for-building-connectorc.md).

# Configuration Settings for Building Connector/C

### 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:

```c
cmake ../connector_c -DCMAKE_BUILD_TYPE=Release -DCMAKE_INSTALL_PREFIX=/usr/local
```

#### 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

|                        |                                              |
| ---------------------- | -------------------------------------------- |
| 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\_SSL | SCHANNEL (windows), otherwise OPENSSL | Specifies type of TLS/SSL library. Valid values are OPENSSL, GNUTLS, and SCHANNEL (Windows only). |

#### 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

```bash
cmake .. -D{PLUGIN_NAME}_PLUGIN_TYPE=[STATIC|DYNAMIC|OFF]
```

Beginning with C/C 3.0.4

```bash
cmake .. -DCLIENT_PLUGIN_{PLUGIN_NAME}=[STATIC|DYNAMIC|OFF]
```

Connector/C 3.0 supports the following plugins:

|                         |                |         |                                                                                                                     |
| ----------------------- | -------------- | ------- | ------------------------------------------------------------------------------------------------------------------- |
| Plugin                  | Type           | Default | Description                                                                                                         |
| PVIO\_SOCKET            | IO             | static  | plugin for client server communication via socket                                                                   |
| PVIO\_SHMEM             | IO             | dynamic | plugin for client server communication via shared memory                                                            |
| PVIO\_NPIPE             | IO             | static  | plugin for client server communication via named pipe                                                               |
| DIALOG                  | Authentication | dynamic | Authentication for user input, e.g. for PAM authentication                                                          |
| MYSQL\_OLD\_PASSWORD    | Authentication | static  | Pre. 4.1 authentication (deprecated). Disabled by default in current versions; not built unless explicitly enabled. |
| MYSQL\_NATIVE\_PASSWORD | Authentication | static  | Default authentication                                                                                              |
| MYSQL\_CLEAR\_PASSWORD  | Authentication | dynamic | Sends password without hashing or encryption                                                                        |
| AUTH\_GSSAPI\_CLIENT    | Authentication | dynamic | Kerberos/GSSAPI authentication plugin                                                                               |
| SHA256\_PASSWORD        | Authentication | dynamic | SHA256 password authentication plugin                                                                               |
| REPLICATION             | Connection     | OFF     | Replication/fail over plugin (experimental)                                                                         |

{% @marketo/form formId="4316" %}