MySQL Connector/C++
MySQL connector library for C and C++ applications
|
Session creation options. More...
Public Types | |
enum | Enum { URI = 1 , HOST = 2 , PORT = 3 , PRIORITY = 4 , USER = 5 , PWD = 6 , DB = 7 , SSL_MODE = 8 , SSL_CA = 9 , AUTH = 10 , SOCKET = 11 , CONNECT_TIMEOUT = 12 , CONNECTION_ATTRIBUTES = 13 , TLS_VERSIONS = 14 , TLS_CIPHERSUITES = 15 , DNS_SRV = 16 , COMPRESSION = 17 , COMPRESSION_ALGORITHMS = 18 , SSL_CAPATH = 19 , SSL_CRL = 20 , SSL_CRLPATH = 21 , LAST } |
Possible session creation options. More... | |
Session creation options.
PRIORITY
should be defined after a HOST
(PORT
) to which it applies.SSL_CA
option requires SSL_MODE
value of VERIFY_CA
or VERIFY_IDENTITY
. If SSL_MODE
is not explicitly given then setting SSL_CA
implies VERIFY_CA
. enum Enum |
Possible session creation options.
Enumerator | |
---|---|
URI | connection URI or string |
HOST | DNS name of the host, IPv4 address or IPv6 address |
PORT | X Plugin port to connect to |
PRIORITY | Assign a priority (a number in range 1 to 100) to the last specified host; these priorities are used to determine the order in which multiple hosts are tried by the connection fail-over logic (see description of |
USER | user name |
PWD | password |
DB | default database |
SSL_MODE | Specify SSLMode option to be used. In plain C code the value should be a |
SSL_CA | path to a PEM file specifying trusted root certificates |
AUTH | Authentication method to use, see AuthMethod. In plain C code the value should be a |
SOCKET | unix socket path |
CONNECT_TIMEOUT | Sets connection timeout in milliseconds. In C++ code can be also set to a |
CONNECTION_ATTRIBUTES | Specifies connection attributes (key-value pairs) to be sent when a session is created. The value is a JSON string (in C++ code can be also a |
TLS_VERSIONS | List of allowed TLS protocol versions, such as "TLSv1.2". The value is a string with comma separated versions. In C++ code it can also be an iterable container with versions. |
TLS_CIPHERSUITES | List of allowed TLS cipher suites. The value is a string with comma separated IANA cipher suitenames (such as "TLS_RSA_WITH_3DES_EDE_CBC_SHA"). In C++ code it can also be an iterable container with names. Unknown cipher suites are silently ignored. |
DNS_SRV | If enabled (true) will check hostname for DNS SRV record and use its configuration (hostname, port, priority and weight) to connect. |
COMPRESSION | enable or disable compression |
COMPRESSION_ALGORITHMS | Specify compression algorithms in order of preference |
SSL_CAPATH | Path to a directory containing PEM files specifying trusted root certificates. |
SSL_CRL | Path to a PEM file containing certificate revocation lists |
SSL_CRLPATH | Path to a directory containing PEM files with certificate revocation lists |